<?php
/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Rest
 * @subpackage Client
 * @copyright  Copyright (c) 2005-2009 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id: Client.php 18173 2009-09-17 15:35:05Z padraic $
 */


/** Zend_Service_Abstract */
require_once 'Zend/Service/Abstract.php';

/** Zend_Rest_Client_Result */
require_once 'Zend/Rest/Client/Result.php';

/** Zend_Uri */
require_once 'Zend/Uri.php';

/**
 * @category   Zend
 * @package    Zend_Rest
 * @subpackage Client
 * @copyright  Copyright (c) 2005-2009 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Rest_Client extends Zend_Service_Abstract
{
	/**
	 * Data for the query
	 * @var array
	 */
	protected $_data = array();

	/**
	 * Zend_Uri of this web service
	 * @var Zend_Uri_Http
	 */
	protected $_uri = null;

	/**
	 * Constructor
	 *
	 * @param string|Zend_Uri_Http $uri URI for the web service
	 * @return void
	 */
	public function __construct($uri = null)
	{
		if (!empty($uri)) {
			$this->setUri($uri);
		}
	}

	/**
	 * Set the URI to use in the request
	 *
	 * @param string|Zend_Uri_Http $uri URI for the web service
	 * @return Zend_Rest_Client
	 */
	public function setUri($uri)
	{
		if ($uri instanceof Zend_Uri_Http) {
			$this->_uri = $uri;
		} else {
			$this->_uri = Zend_Uri::factory($uri);
		}

		return $this;
	}

	/**
	 * Retrieve the current request URI object
	 *
	 * @return Zend_Uri_Http
	 */
	public function getUri()
	{
		return $this->_uri;
	}

	/**
	 * Call a remote REST web service URI and return the Zend_Http_Response object
	 *
	 * @param  string $path            The path to append to the URI
	 * @throws Zend_Rest_Client_Exception
	 * @return void
	 */
	final private function _prepareRest($path)
	{
		// Get the URI object and configure it
		if (!$this->_uri instanceof Zend_Uri_Http) {
			require_once 'Zend/Rest/Client/Exception.php';
			throw new Zend_Rest_Client_Exception('URI object must be set before performing call');
		}

		$uri = $this->_uri->getUri();

		if ($path[0] != '/' && $uri[strlen($uri)-1] != '/') {
			$path = '/' . $path;
		}

		$this->_uri->setPath($path);

		/**
		 * Get the HTTP client and configure it for the endpoint URI.  Do this each time
		 * because the Zend_Http_Client instance is shared among all Zend_Service_Abstract subclasses.
		 */
		self::getHttpClient()->resetParameters()->setUri($this->_uri);
	}

	/**
	 * Performs an HTTP GET request to the $path.
	 *
	 * @param string $path
	 * @param array  $query Array of GET parameters
	 * @throws Zend_Http_Client_Exception
	 * @return Zend_Http_Response
	 */
	final public function restGet($path, array $query = null)
	{
		$this->_prepareRest($path);
		$client = self::getHttpClient();
		$client->setParameterGet($query);
		return $client->request('GET');
	}

	/**
	 * Perform a POST or PUT
	 *
	 * Performs a POST or PUT request. Any data provided is set in the HTTP
	 * client. String data is pushed in as raw POST data; array or object data
	 * is pushed in as POST parameters.
	 *
	 * @param mixed $method
	 * @param mixed $data
	 * @return Zend_Http_Response
	 */
	protected function _performPost($method, $data = null)
	{
		$client = self::getHttpClient();
		if (is_string($data)) {
			$client->setRawData($data);
		} elseif (is_array($data) || is_object($data)) {
			$client->setParameterPost((array) $data);
		}
		return $client->request($method);
	}

	/**
	 * Performs an HTTP POST request to $path.
	 *
	 * @param string $path
	 * @param mixed $data Raw data to send
	 * @throws Zend_Http_Client_Exception
	 * @return Zend_Http_Response
	 */
	final public function restPost($path, $data = null)
	{
		$this->_prepareRest($path);
		return $this->_performPost('POST', $data);
	}

	/**
	 * Performs an HTTP PUT request to $path.
	 *
	 * @param string $path
	 * @param mixed $data Raw data to send in request
	 * @throws Zend_Http_Client_Exception
	 * @return Zend_Http_Response
	 */
	final public function restPut($path, $data = null)
	{
		$this->_prepareRest($path);
		return $this->_performPost('PUT', $data);
	}

	/**
	 * Performs an HTTP DELETE request to $path.
	 *
	 * @param string $path
	 * @throws Zend_Http_Client_Exception
	 * @return Zend_Http_Response
	 */
	final public function restDelete($path)
	{
		$this->_prepareRest($path);
		return self::getHttpClient()->request('DELETE');
	}

	/**
	 * Method call overload
	 *
	 * Allows calling REST actions as object methods; however, you must
	 * follow-up by chaining the request with a request to an HTTP request
	 * method (post, get, delete, put):
	 * <code>
	 * $response = $rest->sayHello('Foo', 'Manchu')->get();
	 * </code>
	 *
	 * Or use them together, but in sequential calls:
	 * <code>
	 * $rest->sayHello('Foo', 'Manchu');
	 * $response = $rest->get();
	 * </code>
	 *
	 * @param string $method Method name
	 * @param array $args Method args
	 * @return Zend_Rest_Client_Result|Zend_Rest_Client Zend_Rest_Client if using
	 * a remote method, Zend_Rest_Client_Result if using an HTTP request method
	 */
	public function __call($method, $args)
	{
		$methods = array('post', 'get', 'delete', 'put');

		if (in_array(strtolower($method), $methods)) {
			if (!isset($args[0])) {
				$args[0] = $this->_uri->getPath();
			}
			$this->_data['rest'] = 1;
			$data = array_slice($args, 1) + $this->_data;
			$response = $this->{'rest' . $method}($args[0], $data);
			$this->_data = array();//Initializes for next Rest method.
			return new Zend_Rest_Client_Result($response->getBody());
		} else {
			// More than one arg means it's definitely a Zend_Rest_Server
			if (sizeof($args) == 1) {
				// Uses first called function name as method name
				if (!isset($this->_data['method'])) {
					$this->_data['method'] = $method;
					$this->_data['arg1']  = $args[0];
				}
				$this->_data[$method]  = $args[0];
			} else {
				$this->_data['method'] = $method;
				if (sizeof($args) > 0) {
					foreach ($args as $key => $arg) {
						$key = 'arg' . $key;
						$this->_data[$key] = $arg;
					}
				}
			}
			return $this;
		}
	}
}
